<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<link rel ="stylesheet" type="text/css" href="marvinmanuals.css" title="Style">
		<title>Marvin OLE User's Guide</title>
	</head>
	<body>
		<center>
			<h1>Marvin OLE User's Guide</h1>
		</center>

		<h2>Contents</h2>
		<ul>
			<li><a href="#intro">Introduction</a>
			<li><a href="#install">Install and Uninstall</a>
			<li><a href="#usage">How to Use</a>
			<li><a href="#knownissues">Known Issues</a>
		</ul>

		<center><div class="lenia">&nbsp;</div></center>

		<h2><a class="anchor" name="intro">Introduction</a></h2>

		<p>Marvin OLE is the ChemAxon solution for <a href="http://en.wikipedia.org/wiki/Object_Linking_and_Embedding" target="_blank">Microsoft's Object Linking and Embedding (OLE)
		technology</a>. It is supported by Windows operating systems. Marvin OLE offers an easy
		way to embed Marvin Sketch drawings into other applications, like Microsoft Office Family products.
		Embedded Marvin Documents can be edited in-place with a fully functional Marvin Sketch.</p>

		<p>Word Documents, Excel Sheets, and many more other files containing embedded Marvin Documents
		are easily distributable. Even people who do not have Marvin installed can access the content
		as an image, however, to edit the Marvin Document itself, they must have a properly installed
		Marvin with OLE support.</p>

		<center><div class="lenia">&nbsp;</div></center>

		<h3><a class="anchor" name="install">Install and Uninstall</a></h3>
                <p>To be able to install or uninstall OLE server, you need
                administrator privileges. Below, you can see how to do it if
                you have got the required rights.
                The OLE server is connecting closer to the Marvin Beans resources.
                When you register a Marvin OLE server it stores a reference
                in the Windows registry about the location of MarvinSketch
                application (that will be launched when you edit an embedded
                Marvin Document).</p>
                <p>The OLE server registers only MarvinSketch in the same install package.<br>
                If a Marvin Beans package is not available, it is possible to
                install OLE server (and required Marvin resources) from
                Marvin Java Web Start (requires to run jnlp with administrator
                privileges).</p>
		<p><b>Installation</b> is automatically handled by Marvin Installer. In any case
		you can not use the installer application provided, you can use Marvin (Edit/Preferences/OLEServer menu)
		to manage OLE Server. For command-line operations, execute <b>marvinOLEserver.exe</b>
		once at your <pre><b>X:\YourMarvinDirectory\lib\</b></pre> folder to access this functionality.</p>
		
		<p><b>Uninstalling</b> Marvin will remove the Marvin OLE support from your machine as well. You can completely disable this feature
		while having your installed Marvin untouched at Edit/Preferences/OLEServer menu, or by executing <pre><b>X:\YourMarvinDirectory\lib\marvinoleserver.exe /unregister</b></pre>
		To re-enable the feature, just execute <b>marvinoleserver.exe</b> without any parameters as described in <b>installation</b>
		section above (or control it via the Edit/Preferences OLEServer menu). It is not necessary to reinstall Marvin, if you had not uninstalled it.</p>
		
		<p><b>Note:</b> 'X:\YourmarvinDirectory' is 'C:\Program Files\Marvin Beans' if you have chosen installing Marvin into 'C:\Program Files\Marvin Beans'</p>
                <h4>Administrator privileges</h4>
                <p><strong>Windows 2000/XP:</strong> Most users have got
                administrator privileges in default (unless the system administrator restricts it). 
                If you have got full control on your machine (install
                anything freely), you have administrator rights. In this case,
                you can register/unregister OLE server yourself and Marvin Beans
                installer/uninstaller will run definitely with admin privileges.</p>
                <p><strong>Windows Vista:</strong> Vista security policy is more strict than earlier Windows versions. 
                If a user has got administrator rights, it
                does not mean that he can run everything with these
                privileges. In default, all programs run without extra rights.
                To run a program with administrator privileges, you have to
                select <strong>Run As Administrator</strong> by launching
                (right-click on the icon of the application and choose
                <code>Run As Administrator</code> option). After selecting
                this option, Vista will ask for confirmation to run the application
                with high privileges, click <strong>Allow</strong>. The application will run in admin mode.<br>
                <strong>Note:</strong> Although Marvin Beans installer/uninstaller does not
                require admin rights, it detects the highest running level and
                tries to run in administrator mode automatically (if it is possible). If the
                installer has got the proper rights, it does registration/unregistration 
                of OLE server in the background during the (un)installation process.
                </p>
		<center><div class="lenia">&nbsp;</div></center>

		<h3><a class="anchor" name="usage">How to Use</a></h3>
		<p>Marvin OLE is accessible via Windows Clipboard. Make sure you have 'OLE Object' enabled
		in Edit/Preferences/Copy (by default, this feature is enabled). Simply select your drawing, or
		any part of it and copy it to clipboard (Ctrl+c). The selection can be pasted into any OLE-capable application,
		like Microsoft Office Family.</p>
		
		<p>This feature also works in a reversed way: select an embedded Marvin OLE document from your Excel Sheet or Word Document,
		copy to the clipboard (Ctrl+c), then use the paste function (Ctrl+v) at your MarvinSketch to retrieve the structure.</p>
		<center><div class="lenia">&nbsp;</div></center>


		<h3><a class="anchor" name="knownissues">Known Issues</a></h3>
		<p><b>Word Pad</b> pops up a dialog indicating that Marvin OLE Server is not responding while inserting a new Marvin Document,
		or editing an exisiting one with MarvinSketch. This causes no harm or data loss, it is an invalid error message fired by Word Pad.
		<b>After</b> you complete the drawing process, and close MarvinSketch, press 'Retry' to close the dialog.</p>
		
		<p><strong>Open Office:</strong> Although Open Office is not supported, this OLE solution works partially on that platform.
        The following issues are known: copy from Open Office into Marvin does not work; the image of the embedded structure is not 
		refreshed after editing without saving the whole office document.</p>
		
		<center><div class="lenia">&nbsp;</div></center>
		<center>
			<font size="-2" face="helvetica">
				Copyright &copy; 1999-2010
				<a href="http://www.chemaxon.com">ChemAxon Ltd.</a>
				&nbsp;&nbsp;&nbsp;All rights reserved.
			</font>
		</center>
	</body>
</html>
